<!DOCTYPE html>
<html lang="en">

<head>
	<meta charset="UTF-8"/>
	<meta name="keywords" content="migration, specification change,outline,AppleScript"/>
	<link rel="stylesheet" href="../../Shared/sty/standard.css"/>
	<script defer src="../../Shared/js/toc.js"></script>
	
	<title>Important changes on CotEditor 2.0</title>
</head>

<body>
<h1>Important changes on CotEditor 2.0</h1>

<p>CotEditor 2.0 includes some specification changes for customization from the previous versions. If you’ve used the legacy version before, you may need some manual migrations.</p>


<section>
<h2>Syntax Style Format</h2>

<p>The format for syntax style definition has been changed significantly. The user customized styles will be translated automatically to the new style format on the first launch of CotEditor 2. However, it is recommend to update or rewrite your styles to conform to the new features for syntax style like the comment-out toggling or new highlighting variations.</p>
<p>You may find some new additional syntax styles on our <a href="https://github.com/coteditor/CotEditor/wiki/Additional-Syntax-Styles" rel="external">Wiki page</a>.</p>
</section>


<section>
<h2>Regular Expression Engine for Outline Extracting</h2>

<p>Those who have customized syntax styles in CotEditor 1.x may have to fix their definition to extract outline menu manually, because the regular expression engine for outline parsing has been changed in 2.0 from Oniguruma to ICU library.
Validate your customized syntax styles in syntax style editor and follow the messages.</p>

<p>The typical points to fix are:</p>

<ul>
	<li><p>The “<code>{</code>” and “<code>}</code>” as character must always be escaped with backslash “<code>\</code>” in ICU, however not in Oniguruma.</p></li>
	<li><p>The definition of “<code>$&amp;</code>” for the whole matched text was removed in 2.0. Use “<code>$0</code>” instead to get the same effect.</p></li>
</ul>

<p>For all regex syntax, see <a href="about_regex.html">Use the regular expression</a>.</p>
</section>


<section>
<h2>API for AppleScript</h2>

<p>Some specifications for scripting support have been updated on CotEditor 2.0. From this, some user scripts may not run correctly on 2.0 without modifying. For details about this specification change, see <a href="script_osascript.html">Automate tasks using AppleScript</a>.</p>
</section>


<section>
<h2>Bundle Identifier</h2>

<p>The bundle identifier for CotEditor was changed from “com.aynimac.CotEditor” to “com.coteditor.CotEditor”. From this change, file mappings or other links to CotEditor (such as, external editor) outside CotEditor can be reset. Please link them again, if links are lost.</p>

<p><em>For advanced users</em>: Notice that the filenames for preferences and the domain name for “<code>defaults</code>” command in Terminal was also changed.</p>
</section>


<section id="cf">
<h2>See also</h2>
<ul>
	<li><a href="whats_new_in_2.0.html">What’s new in CotEditor 2.0?</a></li>
	<li><a href="specification_changes_on_2.2.html">Important changes on CotEditor 2.2</a></li>
	<li><a href="releasenotes.html">Release notes for CotEditor on Mac</a></li>
</ul>
</section>

</body>
</html>
